home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 039a / rzsz1004.zip / RZ.DOC < prev    next >
Text File  |  1991-10-03  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.       rx, rc, rb, rz - Receive Files and Commands with X/Y/ZMODEM
  10.  
  11.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.       rrrrzzzz [-    ttttvvvv]
  13.       rrrrbbbb [-    ttttvvvv]
  14.       rrrrcccc [-    ttttvvvv] _f_i_l_e
  15.       rrrrxxxx [-    ttttvvvv] _f_i_l_e
  16.       ggggzzzz _f_i_l_e ...
  17.       [----][vvvv]rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD
  18.  
  19.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.       This program uses error correcting protocols to receive
  21.       files    over a dial-in serial port from    a variety of programs
  22.       running under    PC-DOS,    CP/M, Unix, and    other operating
  23.       systems.  It is invoked from a shell prompt manually,    or
  24.       automatically    as a result of an "sz file ..."    command    given
  25.       to the calling program.
  26.  
  27.       This is a copyrighted    shareware program.  Commercial use of
  28.       this program is subject to licensing conditions detailed in
  29.       the rz.c source code.     "Commercial Use" includes use of this
  30.       program to receive files from    commercial and/or shareware
  31.       programs not published by Omen Technology INC.
  32.  
  33.       This program is not designed to be called from _c_u(_1),
  34.       _t_i_p(_1), or other communications programs.  Unix flavors of
  35.       Omen Technology's Professional-YAM communications software
  36.       are available    for dial-out applications.
  37.  
  38.  
  39.       RRRRzzzz (Receive ZMODEM) receives one or more files with the
  40.       ZMODEM protocol.  Pathnames are supplied by the sending
  41.       program, and directories are made if necessary (and
  42.       possible).  Normally,    the "rz" command is automatically
  43.       issued by the    calling    ZMODEM program,    but defective ZMODEM
  44.       implementations may require starting _r_z manually.
  45.  
  46.       RRRRbbbb receives file(s) with YMODEM, accepting either standard
  47.       128 byte sectors or 1024 byte    sectors    (YAM sb    ----kkkk option).
  48.       The user should determine when the 1024 byte block length
  49.       actually improves throughput.
  50.  
  51.       If True YMODEM (Omen Technology trademark) file information
  52.       (file    length,    etc.) is received, the file length controls
  53.       the number of    bytes written to the output dataset, and the
  54.       modify time and file mode (iff non zero) are set
  55.       accordingly.
  56.  
  57.       If True YMODEM file information is not received, slashes in
  58.       the pathname are changed to underscore, and any trailing
  59.       period in the    pathname is eliminated.     This conversion is
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 10/3/91)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  71.  
  72.  
  73.  
  74.       useful for files received from CP/M and other    historical
  75.       systems.
  76.  
  77.       RRRRcccc receives a    single _f_i_l_e with XMODEM-CRC or XMODEM-1k-CRC
  78.       protocol.  The user should determine when the    1024 byte
  79.       block    length actually    improves throughput without causing
  80.       problems.  The user must supply the file name    to both
  81.       sending and receiving    programs.  Up to 1023 garbage
  82.       characters may be added to the received file.
  83.  
  84.       RRRRxxxx receives a    single _f_i_l_e with XMODEM    or XMODEM-1k protocol.
  85.       The user should determine when the 1024 byte block length
  86.       actually improves throughput without causing problems.  The
  87.       user must supply the file name to both sending and receiving
  88.       programs.  Up    to 1023    garbage    characters may be added    to the
  89.       received file.
  90.  
  91.       GGGGzzzz is    a shell    script which calls _s_z to command Pro-YAM or
  92.       ZCOMM    to transmit the    specified files.  Pathnames used with
  93.       _g_z must be escaped if    they have special significance to the
  94.       Unix shell.
  95.       EXAMPLE: gz "-a C:*.c    D:*.h"
  96.  
  97.       RRRRzzzz may be invoked as rrrrzzzzCCCCOOOOMMMMMMMMAAAANNNNDDDD (with an optional leading -
  98.       as generated by login(1)).  For each received    file, _r_z will
  99.       pipe the file    to ``COMMAND filename''    where filename is the
  100.       name of the transmitted file with the    file contents as
  101.       standard input.
  102.  
  103.       Each file transfer is    acknowledged when COMMAND exits    with 0
  104.       status.  A non zero exit status terminates transfers.
  105.  
  106.       A typical use    for this form is _r_z_r_m_a_i_l which calls rmail(1)
  107.       to post mail to the user specified by    the transmitted    file
  108.       name.     For example, sending the file "caf" from a PC-DOS
  109.       system to _r_z_r_m_a_i_l on a Unix system would result in the
  110.       contents of the DOS file "caf" being mailed to user "caf".
  111.  
  112.       On some Unix systems,    the login directory must contain a
  113.       link to COMMAND as login sets    SHELL=rsh which    disallows
  114.       absolute pathnames.  If invoked with a leading ``v'',    _r_z
  115.       will report progress to /tmp/rzlog.  The following entry
  116.       works    for Unix SYS III/V:
  117.              rzrmail::5:1::/bin:/usr/local/rzrmail
  118.       If the SHELL environment variable includes _r_s_h or _r_k_s_h
  119.       (restricted shell), _r_z will not accept absolute pathnames or
  120.       references to    a parent directory, will not modify an
  121.       existing file, and removes any files received    in error.
  122.  
  123.  
  124.       The meanings of the available    options    are:
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 10/3/91)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  137.  
  138.  
  139.  
  140.       tttt ttttiiiimmmm
  141.            Change timeout to _t_i_m tenths of seconds.
  142.       vvvv    Verbose causes a    list of    file names to be appended to
  143.            /tmp/rzlog .  More v's generate more detailed debugging
  144.            output.
  145.       (Pro-YAM command)
  146.       <_A_L_T-_2>
  147.       Pro-YAM Command: _s_z *._h *._c
  148.       (This    automatically invokes _r_z on the    connected system.)
  149.  
  150.  
  151.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  152.       Exit status is as follows: 0 for successful transfers.  1 if
  153.       unrecoverable    errors are detected.  2    if syntax errors or
  154.       file access problems are detected.  3    if the program was
  155.       terminated by    a caught interrupt.
  156.  
  157.  
  158.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  159.       Professional-YAM, ZCOMM, DSZ,    crc(omen), sz(omen),
  160.       usq(omen), undos(omen)
  161.  
  162.       Compile time options required    for various operating systems
  163.       are described    in the source file.
  164.  
  165.      NNNNOOOOTTTTEEEESSSS
  166.       ZMODEM's support of XOFF/XON flow control allows proper
  167.       operation in many environments that do not support XMODEM
  168.       uploads.  Unfortunately, not all Unix    versions support input
  169.       flow control.     The TTY input buffering on some systems may
  170.       not adequately buffer    long blocks or streaming input at high
  171.       speed.  You should suspect this problem when you can't send
  172.       data to the Unix system at high speeds using ZMODEM,
  173.       YMODEM-1k or XMODEM-1k, but YMODEM with 128 byte blocks
  174.       works    properly.
  175.  
  176.       The DSZ or Pro-YAM zzzzmmmmooooddddeeeemmmm llll numeric parameter    may be set to
  177.       a value between 64 and 1024 to limit the burst length
  178.       ("zmodem pl128").  Although this compromises ZMODEM's
  179.       throughput, ZMODEM's superior    reliability remains intact.
  180.  
  181.       If a program that does not properly implement    the specified
  182.       file transfer    protocol causes    _r_z to "hang" the port after a
  183.       failed transfer, either wait for _r_z to time out or keyboard
  184.       a dozen Ctrl-X characters.  Every reported instance of this
  185.       problem has been corrected by    using ZCOMM, Pro-YAM, DSZ, or
  186.       other    program    with a correct implementation of the specified
  187.       protocol.
  188.  
  189.       Many programs    claiming to support YMODEM only    support    XMODEM
  190.       with 1k blocks, and they often don't get that    quite right.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                         (printed 10/3/91)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      RRRRZZZZ((((1111))))        OOOOmmmmeeeennnn TTTTeeeecccchhhhnnnnoooollllooooggggyyyy    IIIINNNNCCCC ((((OOOOMMMMEEEENNNN))))         RRRRZZZZ((((1111))))
  203.  
  204.  
  205.  
  206.       In the case of a few poorly designed microcomputers, sending
  207.       serial data to a tty port at sustained high speeds has been
  208.       known    to cause lockups, system halts,    kernel panics, and
  209.       occasional antisocial    behaviour.  This problem is not    unique
  210.       to _r_z; CRT terminals with block mode transmission and    line
  211.       noise    have the same effect.  When experimenting with high
  212.       speed    input to a system, consider rebooting the system if
  213.       the file transfers are not successful, especially if the
  214.       personality of the system appears altered.
  215.  
  216.       The Unix "ulimit" parameter must be set high enough to
  217.       permit large file transfers to Unix.
  218.  
  219.       Telebit modems must not be set to "spoof" UUCP, XMODEM, or
  220.       KERMIT.  Setting one of these    spoofing modes interferes with
  221.       other    protoocls.
  222.  
  223.       32 bit CRC code courtesy Gary    S. Brown.  Directory creation
  224.       code from John Gilmore's PD TAR program.
  225.  
  226.      BBBBUUUUGGGGSSSS
  227.       This version of _r_z does not support some ZMODEM features.
  228.       Unix flavors of Professional-YAM may be linked to "rz" to
  229.       support these    features.
  230.  
  231.       The ASCII option's CR/LF to NL translation merely deletes
  232.       CR's;    undos(omen) performs a more intelligent    translation.
  233.  
  234.      ZZZZMMMMOOOODDDDEEEEMMMM CCCCAAAAPPPPAAAABBBBIIIILLLLIIIITTTTIIIIEEEESSSS
  235.       _R_z supports ZMODEM command execution (zcommand), incoming
  236.       ZMODEM binary    (-b), ASCII (-a), newer(-n), newer+longer(-N),
  237.       protect (-p),    Crash Recovery(-r), clobber (-y),
  238.       match+clobber    (-Y), compression(-Z), and append (-+)
  239.       requests.  Other options sent    by the sender are ignored.
  240.       The default is protect (-p) and binary (-b).
  241.  
  242.       Unix Professional-YAM    provides higher    performance and    other
  243.       features not supported by _r_z.    Please contact Omen Technology
  244.       Inc for product information.
  245.  
  246.       Omen Technology INC
  247.       Post Office Box 4681
  248.       Portland OR 97208
  249.       503-621-3406
  250.  
  251.  
  252.      FFFFIIIILLLLEEEESSSS
  253.       rz.c,    crctab.c, rbsb.c, zm.c,    zmr.c, zmodem.h, rz.1
  254.  
  255.       /tmp/rzlog stores debugging output generated with -vv    option
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                         (printed 10/3/91)
  262.  
  263.  
  264.  
  265.